home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / 2299 / AGTBLURB.TXT next >
Text File  |  1989-11-21  |  37KB  |  860 lines

  1.  
  2.  
  3. INTRODUCTION TO THE ADVENTURE GAME TOOLKIT
  4.  
  5.  
  6. This write-up (1) gives an overview of the Adventure Game Toolkit (AGT), a new
  7. "shareware" adventure game development system, (2) presents a complete
  8. "walkthru" of a small game that was created using AGT, but without any
  9. programming by the game developer, (3) introduces AGT's unique metalanguage
  10. especially designed to give the game developer total control and flexibility
  11. in creating adventure games comparable to those from Infocom, and (4) tells
  12. how to register/order the AGT development system.
  13.  
  14.  
  15. 1 -- OVERVIEW OF THE ADVENTURE GAME TOOLKIT
  16.  
  17.  
  18. The Adventure Game Toolkit is designed to allow you to create and play your
  19. own text adventure games.  Once created, your adventure games can be shared
  20. with and enjoyed by others -- even if they do not have a copy of the Adventure
  21. Game Toolkit themselves.   
  22.  
  23. The Adventure Game Toolkit (AGT) began life as a program by Mark Welch called
  24. the Generic Adventure Game System (GAGS).  Using GAGS it was possible for the
  25. non-programmer to develop complete adventure games using a fixed (but
  26. relatively large) vocabulary of action verbs.  David Malmberg took GAGS and
  27. made a number of enhancements including the ability to customize the
  28. vocabulary and to program complex conditional tests and a rich assortment of
  29. actions and messages using a special metalanguage (designed specifically for
  30. writing adventure games).  The current Adventure Game Toolkit combines the
  31. best features of both approaches to enable the user to create two distinct
  32. levels of adventure games:
  33.  
  34.     (1)  Standard Level games that require no programming experience
  35.          (honestly!), only a fertile imagination.  These Standard Level games
  36.          follow the original GAGS format and only require that the user
  37.          generate the game using a word processor or text editor to describe
  38.          the various locations, objects and results of actions that
  39.          collectively make up the game.
  40.  
  41.     (2)  Professional Level games that also make use of the special adventure
  42.          game metalanguage to create games as complex and rich as the game
  43.          designer's imagination and prose style will allow.  These games
  44.          should be technically comparable with the published text adventure
  45.          games from firms like Infocom.
  46.  
  47.  
  48. FEATURES OF THE ADVENTURE GAME TOOLKIT
  49.  
  50. AGT has a number of features that make it a very comprehensive adventure
  51. product.  These features make AGT more powerful, more professional and easier
  52. to use than any previously available text adventure game development system. 
  53. Some of these key features are: 
  54.  
  55.     POWERFUL
  56.  
  57.          *    Big, complex games with up to 200 locations, 100 inanimate
  58.               objects (e.g., treasures, swords, lakes, trees, books, etc.) and
  59.               100 animate objects (e.g., people, animals or creatures).
  60.  
  61.          *    Large standard vocabulary with potential to define many more
  62.               words unique to a specific adventure.  Typical games can have a
  63.               vocabulary of 500 words or more.
  64.  
  65.          *    Sophisticated parser that can understand (1) complex input
  66.               commands including pronouns (IT, HIM, HER, THEM, MY and ITS),
  67.               and (2) compound commands separated by AND or THEN or
  68.               punctuation symbols, and (3) commands addressed to characters
  69.               within the game.  Here are a few examples of commands AGT can
  70.               handle with ease:
  71.  
  72.                    GET THE FLASH LIGHT AND THEN SWITCH IT ON
  73.                    DROP THE FOOD, THE KEY AND THE BOTTLE THEN UNLOCK THE DOOR
  74.                         WITH THE BRASS KEY AND THEN LEAVE
  75.                    PUT ON THE CLOAK, THEN EXAMINE IT; READ ITS LABEL
  76.                    PLACE THE GREEN ROCK AND THE SMALL PEBBLE BEHIND THE TREE
  77.                    ENTER THE HOUSE; GET ALL; EXIT; SOUTH; SOUTH THEN DOWN
  78.                    SULU, SET A COURSE FOR ALPHA 14
  79.                    SCOTTY, BEAM DOWN A TRICORDER AND THE QWERTY MODULE
  80.  
  81.         *     Special, English-like metalanguage (especially developed for
  82.               writing Adventure games) that gives the game designer total
  83.               control and flexibility in the development of his/her games.
  84.  
  85.         *     Source code available to Registered Users.  Over 13,000 lines of
  86.               Turbo Pascal that may be customized to fit the game designer's
  87.               unique needs.
  88.  
  89.     PROFESSIONAL
  90.  
  91.         *     "Look and feel" of Infocom adventure games with similar screen
  92.               layout and standard vocabulary and routines.
  93.  
  94.         *     Automatic screen adaptation to use either a color or a
  95.               monochrome monitor.  Color combinations may be specified by the
  96.               game designer or by the player during the game.
  97.  
  98.         *     Predefined function and cursor keys to input frequently used
  99.               commands and move directions.
  100.  
  101.         *     SCRIPT and UNSCRIPT commands to echo game output to printer.
  102.  
  103.     EASY-TO-USE
  104.  
  105.         *     Large library of completed games that can be enjoyed simply as
  106.               great entertainment or used as a platform by the game designer
  107.               to build upon and/or learn from.
  108.  
  109.         *     Professionally written documentation totalling about 200 pages.
  110.               Has numerous examples that unveil the "secrets" of great
  111.               adventure writers.
  112.  
  113.  
  114. HARDWARE REQUIREMENTS FOR AGT 
  115.  
  116. The games created by the Adventure Game Toolkit requires a computer with at
  117. least 384K of memory, MS-DOS 2.1, and at least one disk drive.  It is possible
  118. to use any kind of monitor and AGT will automatically adjust its output to
  119. best suit the monitor.
  120.  
  121.   2 -- A "WALKTHRU" OF A STANDARD LEVEL GAME
  122.  
  123.  
  124. Using AGT, it is possible to create games that do not require any programming
  125. knowledge or experience (honestly!).  The game designer just "fills in the
  126. blanks" as he/she describes the locations, objects and characters that
  127. collectively make up the game using his/her word processor or text editor.  As
  128. an example, the following lengthy scenario is from a Standard Level game that
  129. is developed in the AGT printed manual in a detailed, step-by-step tutorial. 
  130. This game was developed without any programming skill:  
  131.  
  132.  
  133.   It is the year 2093.  You, a foolish explorer, decided to wander the
  134. radiation-filled areas near what used to be the nation's capital: Washington,
  135. D.C.  You've found the adventure you sought, though few of your exploits
  136. turned out as you'd expected.
  137.   In your six-month travels, you've been attacked by packs of wild dogs and a
  138. few wilder humans.  Your supplies were stolen weeks ago, and you've been
  139. existing by eating the few surviving vegetables in long-abandoned gardens,
  140. despite the risks of eating food grown in this area.  When you finally tried
  141. to leave this restricted region, you were shot at by patrols who detected too
  142. much radiation in your body. 
  143.   In your ever-more-desperate search for either a safe temporary home or a way
  144. out of the danger-zone, you've begun exploring the hills where other wanderers
  145. have said there are caves and tunnels.  Somewhere here, it is rumored, there
  146. was once an underground complex where the elite few hid during the atomic
  147. cataclysm.  No trace has ever been found of those hidden politicians and
  148. millionaires, though the mysterious roars of explosions were heard two years
  149. after the Last War ended, suggesting that the survivors above ground might
  150. have found and destroyed the survivors who hid below.
  151.   After several weeks of living off the land, you discovered a deep pit,
  152. apparently man-made, at the center of a neatly-rounded hill.  For two days,
  153. you explored the hill, trying to find another cave or even an out-of-place
  154. pile of dirt, to no avail.  Far away to the south are five blackened pits in
  155. the earth, burned, ash-covered remnants of a few days of sheer hell; you've
  156. wondered if their target might have been hills like this.
  157.   Finally, you locate a much-used rope and tie one end around some rocks near
  158. the pit, hoping to lower yourself into it.  As you explore the top few feet of
  159. the cave, you drop your disposable atomic flashlight, and can hear it bounce
  160. against the sides of the cave for several seconds before striking the bottom. 
  161. Slowly, in darkness, you lower yourself down the rope.  Wisely, you started at
  162. noon, and the light is bright enough for you to see above you, though your
  163. body blocks most of the light below.
  164.   As you approach what you think is the bottom of the pit, your legs push
  165. aside a clump of earth and suddenly you are hanging in empty space: the thin
  166. vertical tunnel has widened.  As you turn awkwardly, you try to stop moving by
  167. reaching a hand out to touch the side of the tunnel, only to suddenly lose
  168. your grip with the other hand.  You grab for the rope, but gain only rope
  169. burns as you feel the end of the rope slip from your fingers, hardly slowing
  170. your fall.
  171.   Luckily, you were only about fifteen feet from the bottom of the pit.  Of
  172. course, "only" is a relative term: in this case, it means you'll suffer from
  173. extreme pain and bruises, not broken bones.
  174.   It takes you only a minute to realize that the sides of the pit are too
  175. steep and muddy to climb; the rope is dimly visible twenty feet above.  By
  176. feeling the side of the pit, you can make out some sort of wooden or plastic
  177. door to the west.  Despite the pain you still feel from the fall, you manage
  178. to kick the door open, leading to a dark room.
  179.  
  180. You are in a deep pit.  Climbing back up is simply impossible: the side of the
  181. pit is far too steep and is too slippery to grip.  Through a shattered wooden
  182. door, you can faintly make out an exit to the west.
  183.    There is a iron crowbar here.
  184.    There is a disposable atomic flashlight here.
  185.  
  186. What Now? GET THE FLASHLIGHT AND THEN SWITCH IT ON
  187.           ^
  188.           |
  189.           Note: Throughout this example, the player's input is shown in all   
  190.                 capital letters. 
  191.  
  192. You are now carrying the atomic flashlight.
  193. The flashlight it now on.
  194.  
  195. What Now? GET CROWBAR THEN EXAMINE IT
  196.  
  197. You are now carrying the iron crowbar.
  198. The iron crowbar is about three feet long and weighs about eight pounds.
  199. It might be useful as a weapon or as a tool, depending on the circumstances.
  200.  
  201. What Now? WEST
  202.  
  203. You are in a small, dimly-lit room.  Empty shelves line the wall; this must
  204. have been a storage room of some sort.  A broken plastic door leads east, back
  205. to the pit you fell into.  Another open door leads west.
  206.    There is a large wooden crate here.
  207.    There is a small laser-powered handgun here.
  208.    There is a grey wolf here, snarling and growling at you.
  209.  
  210. What Now? GET THE LASER; SHOOT IT AT WOLF
  211.  
  212. You are now carrying the laser gun.
  213. You aim the gun at the wolf and pull the trigger.  It's a direct hit! The wolf
  214. screeches angrily, and falls to the floor for a moment.  Then it leaps up and
  215. eyes you quite angrily.  Though wounded, it seems no less dangerous or
  216. hostile.
  217. The wolf seems to be getting angrier!
  218.  
  219. What Now? EXAMINE WOLF
  220.  
  221. The wolf is grey, with a few white spots on its belly.  It is also quite
  222. large, almost as tall as you are.  Its claws look sharp.  The wolf does not
  223. look friendly; it growls and snarls, plainly upset that you have disturbed it.
  224. The wolf seems to be getting angrier!
  225.  
  226. What Now? SHOOT WOLF WITH GUN
  227.  
  228. You aim the gun at the wolf and pull the trigger.  It's a direct hit! The wolf
  229. screeches angrily, and falls to the floor for a moment.  Then it leaps up and
  230. eyes you quite angrily.  Though wounded, it seems no less dangerous or
  231. hostile.
  232.  
  233. The wolf seems to calm down for a moment, but suddenly attacks.  Its mouth
  234. opens to reveal teeth grotesquely out of proportion to the rest of its body, a
  235. fact you notice as those same teeth tear your flesh into tiny pieces.
  236.  
  237. Oh dear, you seem to have gotten yourself killed.
  238.  
  239. Would you like me to try to get you resurrected?....  YES
  240.  
  241. I'll try...but don't blame me if something goes wr@#%&&
  242.  
  243.                  ---- POOF ----
  244.  
  245. You are engulfed in a cloud of thick orange smoke, and you emerge coughing and
  246. gasping, and find that you must start all over ...
  247.  
  248. You are in a deep pit.  Climbing back up is simply impossible: the side of the
  249. pit is far too steep and is too slippery to grip.  Through a shattered wooden
  250. door, you can faintly make out an exit to the west.
  251.  
  252. What Now? WEST
  253.  
  254. You are in a small, dimly-lit room.  Empty shelves line the wall; this must
  255. have been a storage room of some sort.  A broken plastic door leads east, back
  256. to the pit you fell into.  Another open door leads west.
  257.    There is a large wooden crate here.
  258.    There is a grey wolf here, snarling and growling at you.
  259.  
  260. What Now? THROW CROWBAR AT WOLF
  261.  
  262. The crowbar soars through the air toward the wolf.  It's a direct hit! The
  263. wolf screeches angrily and writhes in agony as it fades away in a cloud of
  264. green smoke.
  265.  
  266. What Now? GET CROWBAR
  267.  
  268. You are now carrying the iron crowbar.
  269.  
  270. What Now? EXAMINE THE CRATE
  271.  
  272. The crate is about eight feet long by six feet wide by six feet high.  It is
  273. extremely heavy and quite solid.  There is lettering on the side.  It has a
  274. lid nailed to its top.
  275.  
  276. What Now? READ LETTERING
  277.  
  278. The side of the crate says, "U.S.  Emergency Radiation Supplies.  Do Not
  279. Open."
  280.  
  281. What Now? OPEN CRATE
  282.  
  283. You need to unlock it first.
  284.  
  285. What Now? PRY THE LID WITH THE CROWBAR
  286.  
  287. You have now unlocked the wooden crate, using the crowbar.
  288.  
  289. What Now? OPEN CRATE
  290.  
  291. The crate is now open.
  292.  
  293. What Now? EXAMINE IT
  294.  
  295. The crate is about eight feet long by six feet wide by six feet high.  It is
  296. extremely heavy and quite solid.  There is lettering on the side.  It has a
  297. lid nailed to its top.
  298.    There is a huge solid metal cube here.  (in the crate)
  299.  
  300. What Now? EXAMINE THE CUBE
  301.  
  302. The huge metal cube may contain something, but you'd need a heck of a knife --
  303. or a laser -- to cut into it.
  304.  
  305. What Now? FIRE LASER GUN AT CUBE
  306.  
  307. It would really make more sense to specify some living creature.  Hostility
  308. really requires a target of some sort.
  309.  
  310. What Now? GET CUBE
  311.  
  312. You aren't strong enough to carry your current load plus the cube.
  313.  
  314. What Now? WEST
  315.  
  316. This is a large long corridor, leading north and south.  To the east, an open
  317. door leads to a storage room of some kind.  A door to the west is securely
  318. locked.  The flashlight flickers on and off and finally goes out completely. 
  319. However, the iron bar gives off a strange orange glow in this room, lighting
  320. up what would otherwise be a very dark place.
  321.  
  322. What Now? OPEN DOOR
  323.  
  324. You try your best, but the door won't open!
  325.  
  326. What Now? NORTH
  327.  
  328. This is the north end of a long corridor.  An open doorway leads east; an arch
  329. leads north.  The flashlight flickers on and off, but finally stays on.       
  330.  Over the arch is a sign.
  331.  
  332. What Now? READ SIGN
  333.  
  334. "Enlisted Personnel Only.  No Visitors."
  335.  
  336. What Now? EAST
  337.  
  338. This is another storage room.  The shelves on the walls are empty.  The only
  339. exit leads west.  The flashlight flickers on and off, but finally stays on.
  340.    There is a hideous mutant here.  It is hissing and cursing at you.
  341.  
  342. What Now? INSPECT MUTANT
  343.  
  344. The mutant is really ugly!  It looks like it was once a man, but it is
  345. horribly disfigured and has open sores covering most of its body.  It is very
  346. nervous and angry at you for disturbing its lair.
  347.  
  348. What Now? TALK TO THE MUTANT
  349.  
  350. The mutant just listens to you, but remains strangely silent.
  351. The mutant seems to be getting angrier!
  352.  
  353. What Now? KILL MUTANT WITH CROWBAR
  354.  
  355. The crowbar soars through the air toward the mutant.  It's a direct hit!
  356. Unfortunately, the crowbar merely bounces off the mutant's head, and appears
  357. to make it quite angry.
  358. The mutant seems to be getting angrier!
  359.  
  360. What Now? FIRE LASER AT MUTANT
  361.  
  362. You aim the gun at the mutant and pull the trigger.  It's a direct hit! The
  363. mutant screeches angrily and writhes in agony as it fades away in a cloud of
  364. green smoke.
  365.  
  366. What Now? WEST
  367.  
  368. This is the north end of a long corridor.  An open doorway leads east; an arch
  369. leads north.  The flashlight flickers on and off, but finally stays on.
  370.    Over the arch is a sign.
  371.  
  372. What Now? NORTH
  373.  
  374. This is a small entry hall.  An arch leads south to a corridor; smaller arches
  375. lead east and west.  Another passage goes north.
  376.    There is a metal desk near the door.
  377.      There is a small drawer.  (in the desk)
  378.  
  379. What Now? LOOK AT DRAWER
  380.  
  381. The drawer looks like most drawers.
  382.  
  383. What Now? OPEN DRAWER
  384.  
  385. The metal drawer is now open.
  386. What Now? EXAMINE DESK
  387.  
  388. This is a rather ordinary metal desk with a single metal drawer.
  389.    There is a small drawer.  (in the desk)
  390.      There is a small plastic key here.  (in the drawer)
  391.  
  392. What Now? GET THE KEY AND EXAMINE IT
  393.  
  394. You are now carrying the plastic key.
  395. The plastic key is like most keys you've seen.  It is cylindrical and has many
  396. tiny holes through it; optical sensors in the correct lock will respond to it
  397. by opening a door or doing whatever it is the key is meant to do.
  398.  
  399. What Now? EAST
  400.  
  401. Something terrible has happened here, probably a cave-in.  The walls have
  402. collapsed, and all exits are blocked except the door to the west through which
  403. you entered.  Dirt and mud cover much of the floor.
  404.    There is a small, square, electronic module here.
  405.  
  406. What Now? GET MODULE AND EXAMINE IT
  407.  
  408. You are now carrying the rt module.
  409. This is a standard-design RT-584 module.  Like all RT-584s, it is the
  410. functional equivalent of a complete supercomputer with gigabytes of storage
  411. and a knowledge base of some sort.  All you need to do is plug it into an
  412. RT-934 console and push it to access its information.
  413.  
  414. What Now? EAT THE MODULE
  415.  
  416. Eat the module?  You must be kidding!
  417.  
  418. What Now? WEST
  419.  
  420. This is a small entry hall.  An arch leads south to a corridor; smaller arches
  421. lead east and west.  Another passage goes north.  There is a metal desk near
  422. the door.
  423.    There is a small drawer.  (in the desk)
  424.  
  425. What Now? SOUTH
  426.  
  427. This is the north end of a long corridor.  An open doorway leads east; an arch
  428. leads north.  The flashlight flickers on and off, but finally stays on.     
  429. Over the arch is a sign.
  430.  
  431. What Now? SOUTH
  432.  
  433. For some reason, you can't see anything here.
  434.  
  435. What Now? NORTH
  436.  
  437. This is the north end of a long corridor.  An open doorway leads east; an arch
  438. leads north.  The flashlight flickers on and off, but finally stays on.     
  439. Over the arch is a sign.
  440.  
  441. What Now? EAST
  442.  
  443. This is another storage room.  The shelves on the walls are empty.  The only
  444. exit leads west.  The flashlight flickers on and off, but finally stays on.   
  445.   There is an iron crowbar here.
  446.  
  447. What Now? GET CROWBAR
  448.  
  449. You are now carrying the iron crowbar.
  450.  
  451. What Now? WEST
  452.  
  453. This is the north end of a long corridor.  An open doorway leads east; an arch
  454. leads north.  The flashlight flickers on and off, but finally stays on.     
  455. Over the arch is a sign.
  456.  
  457. What Now? SOUTH
  458.  
  459. This is a large long corridor, leading north and south.  To the east, an open
  460. door leads to a storage room of some kind.  A door to the west is securely
  461. locked.  The flashlight flickers on and off and finally goes out completely. 
  462. However, the iron bar gives off a strange orange glow in this room, lighting
  463. up what would otherwise be a very dark place.
  464.  
  465. What Now? INVENTORY
  466.  
  467. You are carrying the following:
  468.   iron crowbar
  469.   plastic key
  470.   rt module
  471.   atomic flashlight
  472.   laser gun
  473.  
  474. What Now? UNLOCK DOOR WITH KEY
  475.  
  476. Nice try, but you can't seem to unlock the door.
  477.  
  478. What Now? SOUTH
  479.  
  480. This is the south end of a long north-south corridor.  You see a large red
  481. triangle painted on the wall next to a doorway to the south.  The flashlight
  482. flickers on and off, but finally stays on.
  483.  
  484. What Now? SOUTH
  485.  
  486. This is an elevator car, with an electroluminescent control panel.  The
  487. turbo-thrusters hum quietly beneath your feet, ready to rush you to your
  488. destination.
  489.    There is a blue square visible on the control console.
  490.  
  491. What Now? EXAMINE SQUARE
  492.  
  493. The blue square is an image on the touchscreen of the elevator command
  494. console.  The command console is intended to be useful to anyone who can
  495. recognize simple graphic icons, even if they don't speak English.
  496.  
  497. What Now? PUSH SQUARE
  498.  
  499. As soon as your finger touches the blue square image on the control panel, the
  500. doors slide shut and you are slammed violently against the west wall as the
  501. car begins moving sideways, toward the east.  Just as you get used to that
  502. motion, the car begins dropping, then seems to be both dropping and moving to
  503. the south.  Panicked, you poke at the control panel, but nothing is displayed
  504. on it and it rudely ignores your whimpering.
  505.    After a few minutes, the car's motion settles into a southeast direction,
  506. and seems to stop dropping.  There's no way to tell how fast -- or far -- the
  507. car is traveling.
  508.    As suddenly as it started, the car brakes, cuts to the west, and stops.  To
  509. your surprise and confusion, the door opens behind you, to the south.  This is
  510. an elevator car, with an electroluminescent control panel.  The
  511. turbo-thrusters hum quietly beneath your feet, ready to rush you to your
  512. destination.
  513.    There is a red triangle visible on the control console.
  514.  
  515. What Now? SOUTH
  516.  
  517. You are on a platform outside the hatch leading into a space shuttle.  The
  518. shuttle hatch is open to the south.  An elevator is to the north.
  519.  
  520. What Now? ENTER SHUTTLE
  521.  
  522. This is the bridge, the command hub of the shuttle.  The only visible exit is
  523. to the north.  Like most space vehicles, this one runs almost entirely
  524. automatically, with all flight parameters pre-programmed.  There is a command
  525. console here, but it is dark.  Mounted just below it is a small keyhole.  It
  526. is currently set to 'off.'
  527.  
  528. What Now? TURN KEY
  529.  
  530. As you turn the key in the keyhole, you feel a surge as the ion drives prepare
  531. for a long-awaited takeoff.  The whole ship begins to rumble and shake as the
  532. overhead bay doors are opened by huge motors built into the hillside, and you
  533. hear and feel vibrations as debris from above bounces off the shuttle.
  534.     Out of fear, you reach to turn the key off, but it twists and breaks in
  535. the lock.  The engines surge more violently, and you are slammed against the
  536. floor as the shuttle begins to rise into the air.
  537.     Instantly, you realize that the bay doors have failed, because you can
  538. feel the shuttle collide with something as it ascends.  The computer corrects
  539. for the damage somehow and the shuttle continues to rise, but is vibrating
  540. violently.  The ion drives begin to squeal abnormally, and you realize that
  541. the shuttle cannot possibly remain in one piece for more than a few minutes.
  542.     As if expecting your panic, a wall panel suddenly slides to one side,
  543. revealing an escape pod.
  544.  
  545. This is the bridge.  The exit to the north has been damaged by the vibrations
  546. and is twisted into an impossible position.  An escape pod is visible to the
  547. west.
  548.  
  549. What Now? WEST
  550.  
  551. You are now in the escape pod.  As you sit in the command couch, the door
  552. slides shut behind you and you feel the pod automatically ejecting from the
  553. shuttle.  Not surprisingly, it hits something on the way out, and spins out of
  554. control for a moment before its thrusters regain control.  You can hear the
  555. wind rushing by, and then the sound of an explosion -- very near by -- drowns
  556. out all other sounds.  The escape pod rises for a few minutes, then begins to
  557. move horizontally.  It's hard to tell what is happening, but it's certainly
  558. not as bad as what was happening just a few seconds ago.
  559.     Directly before you is an extremely simple manual console with a small
  560. socket, above which are instructions which say "insert command module here."
  561.  
  562. What Now? INSERT MODULE
  563.  
  564. As you insert the RT-584 module, it exerts some sort of magnetic force which
  565. pulls it from your fingers and snugly into the RT-500 socket.  The escape pod
  566. changes direction and velocity -- almost seeming to stop for a moment -- and
  567. then accelerates again toward some unknown destination.  After a few minutes,
  568. you feel the pod turning and then decelerating and descending.  Before you
  569. expected it, the pod touches down roughly, causing you to bump your head
  570. against the side of the pod.  The pod's engines begin whining as they reduce
  571. power.  The door suddenly clicks and swings open, revealing bright sunlight
  572. outside.  Once the door is locked open, the pod's engines shut down
  573. completely, leaving you in complete silence.
  574. You are in the escape pod, which is not moving.  An open door leads east.
  575.  
  576. What Now? EAST
  577.  
  578. You emerge from the pod to find the sun shinning brightly.  The air is fresh
  579. and clean and smells like spring flowers.  For the first time in a long while,
  580. you feel good about being alive.
  581.  
  582. *** Congratulations.  You have won the game.  ***
  583.  
  584. You have seen 16 rooms (out of 17), in 60 turns.
  585. Your score is 15 out of a possible 15 points.
  586. (The game was saved 0 times and restored 0 Times.)
  587. 3 -- INTRODUCTION TO AGT'S METALANGUAGE FOR CREATING PROFESSIONAL LEVEL GAMES
  588.  
  589.  
  590. The Adventure Game Toolkit comes with a number of complete, ready-to-play
  591. adventure games including an AGT version of the "Colossal Cave" (sometimes
  592. called the "Original Adventure") by Woods and Crowther.  The AGT version of
  593. this classic game has over 140 locations, a vocabulary of about 500 words, and
  594. is comparable in quality and playability to professional games from firms like
  595. Infocom.  The complete source code for this classic game is included as part
  596. of the basic AGT package.  The AGT version of the "Colossal Cave" is a
  597. Professional Level game that makes use of AGT's unique English-like
  598. metalanguage -- developed especially for writing adventure games.
  599.  
  600. Metalanguage commands consist of various conditional tests and actions to be
  601. executed.  These commands are very English-like and easy to understand.  For
  602. example, below are a few typical conditional tests:
  603.  
  604.     Sample Conditions        Explanation
  605.     -----------------        -----------
  606.     NOT AtLocation 5         Tests if player is NOT in Room 5
  607.     IsOpen 208               Tests if Noun 208 is currently open
  608.     Present 210              Tests if Noun 210 is currently nearby
  609.     NOT Present 210          Tests if Noun 210 is NOT currently nearby
  610.     TurnsGT 25               Tests if game has lasted more than 25 turns
  611.     Chance 10                Test has a 10% chance of being TRUE
  612.     VerbIsDirection          Tests if player is trying to leave Room
  613.     ScoreLT 20               Tests if player's score is less than 20 points
  614.     CounterEquals 4 100      Tests if Counter number 4 equals 100
  615.     IsCarrying 203           Tests if player is carrying Noun 203
  616.     OR                         OR
  617.     IsCarrying 204             is carrying Noun 204
  618.     NamePresent              Tests that command's Addressee is nearby
  619.     RoomNeedsLight           Tests if current Room needs a light
  620.  
  621. There are a total of 84 separate meta-command conditional tests.  Since each
  622. may be prefaced by a NOT, there are actually a total of 168 conditional tests
  623. in the AGT metalanguage.  These tests may be connected by multiple "OR's" to
  624. create compound conditional tests.
  625.  
  626. In addition to conditions, there are 71 metalanguage action codes or tokens. 
  627. For example:
  628.  
  629.     Sample Actions           Explanation
  630.     --------------           -----------
  631.     GoToRoom 23              Sends the player to Room 23
  632.     PutInCurrentRoom 205     Puts Noun 205 in current Room
  633.     PrintMessage 47          Prints message number 47 from .MSG file
  634.     LockNOUN                 Lock the current NOUN
  635.     SwapLocations 206 207    Swap the locations of Nouns 206 and 207
  636.     PlusScore 10             Add 10 points to player's score
  637.     KillPlayer               Kill player at end of current turn
  638.     SendToRoom 225 57        Send Noun 225 to Room 57
  639.     DestroyNOUN              Destroy current NOUN (sends it to Room zero)
  640.     DescribeThing 310        Prints the description of Creature 310
  641.     TurnCounterON 4          Starts Counter number 4 counting at 1
  642.     ChangePassageway 1 35    Creates a passage: North(1) to Room 35
  643.     ChangePassageway 1 0     Closes the passage in direction 1 (North)
  644.  
  645.  
  646. META-COMMAND EXAMPLES
  647.  
  648. Here are a few typical examples of AGT metalanguage commands.  The following
  649. meta-commands would allow the adventure game player to CLIMB a TREE and to
  650. CROSS a BRIDGE during a game: 
  651.  
  652.   COMMAND CLIMB TREE 
  653.     InRoom 208 (* The sturdy oak tree is in the room *) 
  654.     OR
  655.     AtLocation 23 (* a location in the forest *)
  656.     OR
  657.     AtLocation 47 (* a location in the forest *)
  658.     OR
  659.     AtLocation 82 (* a location in the forest *)
  660.     GoToRoom 36 (* Go to branches at top of oak tree *) 
  661.     PrintMessage 43 (* You climb up to the top of the tree. *) 
  662.     DoneWithTurn 
  663.   END_COMMAND 
  664.  
  665.   COMMAND CROSS BRIDGE 
  666.     AtLocation 23 (* At West side of bridge *) 
  667.     GoToRoom 24 (* Go to East side of bridge *) 
  668.     PrintMessage 44 (* You walk across the bridge to the other side. *) 
  669.     DoneWithTurn 
  670.   END_COMMAND 
  671.  
  672.   COMMAND CROSS BRIDGE 
  673.     AtLocation 24 (* At East side of bridge *) 
  674.     GoToRoom 23 (* Go to West side of bridge *) 
  675.     PrintMessage 44 (* You walk across the bridge to the other side. *) 
  676.     DoneWithTurn 
  677.   END_COMMAND 
  678.  
  679. The words within the "(*" and "*)" are comments; they are not actually part of
  680. the meta-command itself.  The messages referred to in the "PrintMessage"
  681. actions above would be contained in a separate message file.
  682.  
  683. Here is another example, where meta-commands are set up to create the proper
  684. game response whenever the player inputs a command to KISS something: 
  685.  
  686.   COMMAND KISS PRINCESS 
  687.     InRoom 305 (* Princess is here *) 
  688.     AtLocation 99 (* In Bridal Suite of palace *) 
  689.     PrintMessage 45 (* The princess melts into your strong arms, etc. *) 
  690.     PlusScore 25 (* Bonus for Kiss *) 
  691.     WinGame (* Win the game *) 
  692.     DoneWithTurn 
  693.   END_COMMAND 
  694.  
  695.   COMMAND KISS PRINCESS 
  696.     InRoom 305 (* Princess is here *) 
  697.     NOT AtLocation 99 (* Not in the Bridal Suite of palace *) 
  698.     PrintMessage 46 (* The princess pushes you away coyly, "Not here!" *) 
  699.     DoneWithTurn 
  700.   END_COMMAND 
  701.  
  702.   COMMAND KISS TROLL 
  703.     InRoom 307 (* Ugly Troll is here *) 
  704.     PrintMessage 47 (* The troll kills you! *) 
  705.     KillPlayer (* That will teach you to KISS THE TROLL!! *) 
  706.     DoneWithTurn 
  707.   END_COMMAND 
  708.  
  709.   COMMAND KISS ANY 
  710.     NOUNpresent (* NOUN (whatever it is) is here *) 
  711.     PrintMessage 48 (* You try to $VERB$ the $ADJECTIVE$ $NOUN$ for awhile. *)
  712.     MinusScore 10 (* penalty for sick mind *) 
  713.     DoneWithTurn 
  714.   END_COMMAND 
  715.  
  716.   COMMAND KISS ANY 
  717.     PrintMessage 49 (* The $ADJECTIVE$ $NOUN$ isn't here! *) 
  718.     MinusScore 10 (* penalty for sick mind *) 
  719.     DoneWithTurn 
  720.   END_COMMAND 
  721.  
  722. Meta-commands are processed in the order encountered -- so the last two "KISS
  723. ANY" meta-commands above represent "default" commands and would be activated
  724. only if you weren't trying to KISS the PRINCESS or the TROLL.  For example, if
  725. you gave the input "KISS THE BLARNEY STONE", the game would respond with "You
  726. try to kiss the blarney stone for a while" (Message number 48 in the message
  727. file) or "The blarney stone isn't here!" (Message number 49) depending upon if
  728. the Blarney stone is present at your current location or not.
  729.  
  730. Meta-commands can also be used for "random events", such as, (1) having a
  731. dwarf appear in the room and throw an axe at the player, or (2) having a bear
  732. (that the player has befriended) follow him into a new room, or (3) having a
  733. voice boom out an announcement that "The Cave will close in 25 turns", or (4)
  734. having the player die because of some random event (e.g., falling into a pit).
  735.  
  736.  
  737. Below are a few examples of typical "random event" meta-commands.  These meta-
  738. commands will be tested for ANY player input and if the conditions are
  739. satisfied, the meta-command's actions will be taken. 
  740.   COMMAND ANY 
  741.    Present 210 (* Blazing torch is here *) 
  742.    CounterGT 2 75 (* Torch has been lit for at least 75 turns *) 
  743.    PrintMessage 21 (* Your torch is flickering and growing weaker *) 
  744.    CounterEquals 2 100 (* Torch has been lit for 100 turns *) 
  745.    PrintMessage 22 (* The torch finally goes out! *) 
  746.    TurnCounterOFF 2 (* Torch has gone out, so turn torch counter OFF *) 
  747.    SwapLocations 210 211 (* swap blazing torch for unlit torch *) 
  748.   END_COMMAND 
  749.  
  750.   COMMAND ANY 
  751.    NOT Present 312 (* Angry guard is NOT in room (yet) *) 
  752.    Chance 10 (* 10 % chance of guard appearing *) 
  753.    PutInCurrentRoom 312 (* put guard in room *) 
  754.    PrintMessage 23 (* An angry guard suddenly storms into the room! *) 
  755.   END_COMMAND 
  756.  
  757.   COMMAND ANY 
  758.    FlagON 5 (* Flag 5 is ON if player has befriended parrot *) 
  759.    PutInCurrentRoom 306 (* Once befriended, parrot stays with player *) 
  760.    VerbIsDirection (* Player is going to new room *) 
  761.    PrintMessage 24 (* The parrot flies after you and lands nearby. *) 
  762.   END_COMMAND 
  763.  
  764.   COMMAND ANY 
  765.    InRoom 306 (* The parrot is here *) 
  766.    FlagOFF 4 (* Parrot is thirsty if Flag 4 is OFF *) 
  767.    Chance 5 (* 5 % chance of parrot talking *) 
  768.    PrintMessage 25 (* The parrot squawks "Polly wants a beer!" *) 
  769.   END_COMMAND 
  770.  
  771.   COMMAND ANY 
  772.    InRoom 308 (* A vampire bat is here *) 
  773.    Chance 5 (* 5 % chance of being bitten *) 
  774.    PrintMessage 26 (* The vampire bat bites you on the neck!! *) 
  775.    KillPlayer (* Too bad, but vampire bat bites are fatal! *) 
  776.    DoneWithTurn (* No further process for this turn *) 
  777.   END_COMMAND 
  778. 4 -- HOW TO GET A COPY OF THE ADVENTURE GAME TOOLKIT
  779.  
  780. The Adventure Game Toolkit (AGT) is distributed as "Shareware".  Copies can be
  781. found on many electronic bulletin boards and time-sharing services including
  782. Genie, CompuServe and BIX.  AGT is also available by mail directly from the
  783. authors at:
  784.  
  785.              Softworks 
  786.              43064 Via Moraga 
  787.              Mission San Jose, California  94539 
  788.  
  789. You can also order by phone using your Mastercard or VISA to (415) 659-0533,
  790. 9:00 AM to 6:00 PM, PST ONLY.
  791.  
  792. The price list for various versions/options of AGT is as follows: 
  793.  
  794. 1.  AGT Registration ................................. @ $ 20.00 ea  $ ______
  795.     includes: (1) Notice of all future AGT upgrades, new AGT Adventures
  796.     and related AGT products.  (2) Latest version of the program, sample
  797.     Adventure game source files (CAVE, CRUSADE, UNDERGND, ALICE and
  798.     others), and summary documentation on disk.  Over one megabyte of
  799.     program and data files -- ARCed on two disks. (3) Telephone support
  800.     from 7:00 to 9:00 PST (M-F).  (4) A warm glow from having supported
  801.     at least one of the many Shareware products you probably use.
  802.     (5) The AGT authors' eternal gratitude.
  803.  
  804. 2.  Above with printed AGT manual .................... @ $ 35.00 ea  $ ______
  805.     includes: Above items plus printed manual about 200 pages long with
  806.     numerous detailed examples on how to use the Adventure Game Toolkit
  807.     to create very professional and very clever Adventure games.
  808.     The printed AGT manual has approximately twice the amount of
  809.     information as contained in the summary disk documentation.
  810.  
  811. 3.  Printed AGT manual (Only) ........................ @ $ 20.00 ea  $ ______
  812.  
  813. 4.  UPGRADE to the newest AGT version (Only) ......... @ $ 12.00 ea  $ ______
  814.     includes: Latest version of the program, sample Adventure game
  815.     source files (CAVE, CRUSADE, UNDERGND, ALICE and others), and
  816.     summary documentation on disk.  Over one megabyte of program and
  817.     data files -- ARCed on two disks.
  818.  
  819. 5.   AGT Turbo Pascal source code ..................... @ $ 50.00 ea  $ ______
  820.     includes: Pascal source code (Atari ST, IBM or Mac) for AGT's
  821.     COMPILE and RUN programs.  Over 13,000 lines of Turbo Pascal
  822.     source code (be sure to specify IBM, Atari ST or Macintosh Pascal).
  823.     YOU MUST BE A REGISTERED AGT USER TO ORDER THE SOURCE CODE!
  824.  
  825.     Orders are normally shipped by US mail at no additional charge.
  826.  
  827.     For UPS shipment, please add $4.00..................@ $ 4.00 ea  $ ______
  828.  
  829.     For shipments outside the United States, please add @ $ 8.00 ea  $ ______
  830.  
  831.                                                     Subtotal           ______
  832.  
  833.     (California residents please add 7% sales tax)             Tax     ______
  834.  
  835.                               U.S. Funds Only, Please!! ---->  Total $ ______
  836.  
  837. Payment by:    ( ) Check    ( ) MasterCard    ( ) VISA    ( ) Cash
  838.  
  839.  
  840.    Name: ____________________________________________________________
  841.  
  842. Company: ____________________________________________________________
  843.  
  844. Address: ____________________________________________________________
  845.  
  846.        : ____________________________________________________________
  847.  
  848.   State: ___________________________ Zip:____________________________
  849.  
  850. Day Phone: _________________________ Eve: ___________________________
  851.  
  852.  Card #: _________________________________ Exp. Date: _______________
  853.  
  854. Signature of cardholder: ____________________________________________
  855.  
  856. Version desired: ______ Atari St  ______ Macintosh
  857.  
  858.                  ______ IBM 5 1/4  ______ IBM 3 1/2
  859.  
  860.